home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / ggg_0100.zip / GGGRAPH.DOC < prev    next >
Text File  |  1991-04-09  |  6KB  |  150 lines
  1.  
  2.      GGGraph 0.99...  Copyright (c) 1991 by John Morris
  3.  
  4.  
  5. What is GGGraph?
  6. ----------------
  7.  
  8.   GGGraph is what is typically called a 'graphics shell' program which can
  9. receive special character sequences and turn them into graphics commands.
  10.  
  11.   GGGraph is not application-specific, but currently only works with TW2. TW2
  12. release 11.10 was designed to use GGGraphs special graphics capabilities
  13. to produce real graphics, along with ANSI graphics.  Because GGGraph isn't
  14. application-specific, you will not need to update GGGraph if TW2's graphics
  15. commands change. You simply replace the old graphics command file with a new
  16. one.
  17.  
  18.   GGGraph has a specific set of functions it can run.  The door programmer
  19. simply has to create a command file (???.CMD) which tells GGGraph which
  20. graphics commands to run when a certain sequence is sent thru the modem.
  21. Two different door programs could theoretically send graphics sequence '1'
  22. and GGGraph would produce two different results, depending on the CMD file.
  23.  
  24.   In this way GGGraph could be used to see graphics by several different
  25. doors by loading a different command file for each door.
  26.  
  27.   Since the graphic sequences are only 2 bytes in length, the graphics
  28. commands occur quite rapidly (No screen should take longer than 2 or 3
  29. seconds to be drawn, and that's at 300 bps!).
  30.  
  31. What is required to run GGGraph?
  32. --------------------------------
  33.  
  34.   Since GGGraph will produce 'real' graphics, it uses video mode 16, which
  35. is 640x350 with 16 colors. This mode is available on EGA, and VGA adapters
  36. only. You MUST have an EGA, or VGA to run GGGraph.
  37.  
  38.   A connection with the remote modem using the parameters: No parity, 8 data
  39. bits, and 1 stop bit  is required! This is because GGGraph uses a binary type
  40. code to send the two-byte graphics commands. One byte must have a range of
  41. 0 to 255, so you must have 8 data bits.
  42.  
  43. GGGraph command line parameters
  44. -------------------------------
  45.  
  46.   GGGraph currently supports these command line parameters:
  47.   [option]    -- Please note, items in double brackets are optional.
  48.  
  49.  
  50.   /Bxxx          Sets the bps rate for use by GGGraph. /B2400 sets the bps rate
  51.                  at 2400
  52.  
  53.   /Cx[,ww,yy,zz] Set the communications port.  /C1 means use COM1
  54.                  GGGraph has defaults to:
  55.  
  56.                  COM1 - UART Base: 0x3f8  IRQ Mask: 0x10  Interrupt Vector: 12
  57.                  COM2 - UART Base: 0x2f8  IRQ Mask: 0x08  Interrupt Vector: 11
  58.  
  59.                  For COM1 & 2 you can use 'short' form of the /C command
  60.                  because the defaults are built in for them.
  61.                  If you wish to use a port above COM2, you need to use the
  62.                  long form of the /C command: /Cx,ww,yy,zz
  63.  
  64.                  x  - The com port number. You must use a number above 2
  65.                       to enable the long form of the /C command. The com port
  66.                       number isn't really important. You can use the number
  67.                       3 in any situation. What GGGraph really needs to know
  68.                       are the following numbers.
  69.                  ww - UART Base address (in hexadecimal format)
  70.                  yy - IRQ Mask          (in hexadecimal format)
  71.                  zz - Interrupt Vector  (in decimal format)
  72.  
  73.   /Ffilename.ext Loads in a specific CMD file. If you don't use the /F
  74.                  command then GGGraph will load TW2.CMD as the default.
  75.                  If you use the /F command, you must give the complete
  76.                  filename and extension. GGGraph will not run without a
  77.                  CMD file loaded.
  78.  
  79.   /N             If you have a 16550A UART chip, you can use this command to
  80.                  tell GGGraph NOT to use the FIFO buffers in the chip.
  81.  
  82.   /S             Tells GGGraph that it is okay to use sound. Using the speaker
  83.                  in some situations isn't always good, so by default, sound
  84.                  is OFF.
  85.  
  86. Examples:
  87.  
  88. GGGRAPH /B19200 /C2
  89.  
  90. This command sets the bps rate at 19200,N,8,1 on COM2
  91.  
  92. GGGRAPH /B1200 /C1 /S
  93.  
  94. means use COM1 at 1200,N,8,1, and it's okay to use the speaker
  95.  
  96. GGGRAPH /B115200 /C3,0x2e0,0x10,12 /N
  97.  
  98. means use COM3 where the UARTs base address is 0x2e0, and IRQ mask of 0x10,
  99. an interrupt vector of 12, and don't use the 16550 FIFO buffers. Set the bps
  100. rate at 115200,N,8,1.
  101.  
  102. Files that come with GGGraph
  103. ----------------------------
  104.  
  105. GGGraph comes with several files. 5 of them are TW2 11.10 specific. They are:
  106. CLASS?.DAT, and TW2.CMD    You must have these files in the current directory
  107. if you are running GGGraph with TW2. To turn your graphics on or off in TW2
  108. release 11.10 (and up) use the 'O' command at the 'TW2 Command?' prompt.
  109.  
  110. Non-specific files include GGGRAPH.DOC (this file), and MODERN.FON (font
  111. file).
  112.  
  113.  
  114. Commands available in GGGraph
  115. -----------------------------
  116.  
  117.   There are two basic commands available once you are inside GGGraph.
  118.  
  119.   Alt-C     Clears the screen  not usually needed in graphics mode, as the
  120.             remote door program will clear the screen quite often.
  121.  
  122.   Alt-S     Toggles the speaker on/off.  The remote end must be able to send
  123.             sound commands to GGGraph. (also see the /S command line switch)
  124.  
  125.   Alt-X     Exit GGGraph
  126.  
  127.  
  128. What I use to make GGGraph
  129. --------------------------
  130.  
  131. GGGraph started out as 'GSHELL' in late '89.  I was then using Microsoft
  132. C 5.1 to do my compiling.. but for some reason C5.1 couldn't compile the
  133. GSHELL code.. An 'Internal Compiler Error' of all things popped up when
  134. I tried to compile GSHELL.  QuickC 2.0 compiled it fine.. but it didn't
  135. support the memory models I needed.. so GSHELL was put on the back-burner
  136. till I could get time to work on it again.. this time as GGGraph.
  137.  
  138. GGGraph is compiled with Microsoft C 6.00A, and uses Microsofts graphics
  139. library.
  140.  
  141. For communications, I switched from a FOSSIL/Greenleaf CommLib combo to
  142. the shareware MCOMM library by Mike Dumdei.  I had used Mike's ANSIDRV
  143. routines in TW2 for about a year, liked them, so I am trying the whole
  144. MCOMM package out for the first time with GGGraph.
  145.  
  146. For sound, GGGraph uses my own little creation called Muzak which uses
  147. a macro language very similar to BASIC's PLAY statement. Muzak is
  148. written in C, and uses 'in-line assembly' liberally. Like the graphics
  149. commands, Muzak gets the macro strings from the command (.CMD) file.
  150.